home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr15 / rmastr36.zip / RM.DOC < prev    next >
Text File  |  1993-06-17  |  13KB  |  328 lines
  1.                        Raster Master V3.6
  2.  
  3.           (c) Copyright 1991-93 by Blueview Software.
  4.                       All Rights Reserved. 
  5.  
  6.  
  7.  
  8.  
  9.  
  10. Introduction...
  11.  
  12.   Raster Master is a powerful sprite/icon editor that allows programmers to
  13.   create and edit small images. Raster Master can edit images from 1x1 pixels
  14.   up to 100x100 pixels. Images can be saved in standard PCX format or as source
  15.   code. Raster Master was designed to work in conjunction with other toolkits
  16.   and graphic libraries. This includes Fastgraph and TEGL Windows Toolkit as
  17.   well as the standard graphic libraries for Turbo C, QuickC, Turbo Pascal, and
  18.   QuickBasic.  Additional BMP and ICO formats are supported for Windows 3
  19.   programmers.
  20.  
  21.  
  22. Requirements...
  23.  
  24.   VGA Card, SVGA optional for the 256 color mode
  25.   Mouse
  26.   DOS 3.0 or higher
  27.  
  28.  
  29. Customer Service...
  30.  
  31.      If you have any questions, comments, or suggestions,
  32.      Blueview Software can be contacted by several ways.
  33.  
  34.      BBS   - Baudeville BBS (416) 283-0114
  35.            - Leave message to NICK ONOUFRIOU in the main conference.
  36.  
  37.      Shareware Conferences - RIME, INTELEC, NANET, CITY2CITY, FIDONET,
  38.                              and ILINK. Leave message to NICK ONOUFRIOU.
  39.  
  40.      Internet: nick.onoufriou@bville.gts.org
  41.                nick.onoufriou@canrem.com
  42.  
  43.      Fido net-mail: 1:250/304
  44.                     1:229/15
  45.  
  46.      Surface Mail  - Blueview Software
  47.                      2300 Lawrence Ave. East BOX 80551
  48.                      Scarborough, Ontario
  49.                      CANADA  M1P 2R0
  50.  
  51.      NOTE: All mail _will_ be answered. If you do not receive a reply
  52.            within a few days please try again, mail does get lost.
  53.  
  54.  
  55.  
  56. Using the editor...
  57.  
  58. OPEN/SAVE:  Click in the FILENAME area and type in the name.
  59.  
  60. Any FILE in the FILE LISTING can be selected by simply pointing to it.
  61.  
  62. DIRECTORIES can be accessed in one of two ways. Either by changing the contents
  63. of the DIRECTORY area or pointing to the actual directory in the listing.
  64.  
  65. CHANGING THE OPEN FORMAT: Press the RIGHT mouse button over the OPEN gadget.
  66.  
  67. CHANGING THE SAVE FORMAT: Press the RIGHT mouse button over the SAVE gadget.
  68.  
  69. Use the up and down gadgets to select the new format.
  70.  
  71.  CLR       Clears the screen.
  72.  
  73.  UNDO      Deletes last step taken.
  74.  
  75.  GRID      Toggles the grid ON/OFF.
  76.  
  77.  SIZE      Allows you to select the size of the zoom area. 25x25, 50x50,
  78.            100x100 pixels are supported.  The scrollers can be used to move to
  79.            different areas of the image when in the 25x25 or 50x50 zoom mode.
  80.  
  81.  VIEW      Previews  drawing in one of the listed resolutions.
  82.  
  83.  MODE      Toggles between 16 and 256 color mode. Note: ONLY registered users
  84.            will be given the opportunity to save their images in the 256 color
  85.            mode.
  86.  
  87.  EXIT      Exits Raster Master.
  88.  
  89.  CLIP      Switches to clip mode allowing you perform the following functions.
  90.  
  91.            OPEN/SAVE: Works the same way as the OPEN/SAVE described above. When
  92.                       OPENing/Saving, only the clipped area will be affected.
  93.  
  94.            HFLIP/VFLIP: Horizontally/vertically flips the clipped image.
  95.  
  96.            LEFT/RIGHT/UP/DOWN:  Scrolls the clipped image in the appropriate
  97.                                 direction.
  98.  
  99.            EXIT:  Returns to the main menu.
  100.  
  101.  
  102. Drawing tools...
  103.  
  104.       FREEHAND DRAWING  Move the pointer inside the zoom area and click to plot
  105.                         a pixel.
  106.  
  107.       SPRAY PAINT  Randomly plot pixels until release of mouse button.
  108.  
  109.       FLOOD PAINT  Fills an enclosed area with the current color.
  110.  
  111.       ALL remaining tools work by selecting the starting point, dragging the
  112.       mouse, then releasing the mouse button.
  113.  
  114.  
  115. Selecting colors...
  116.  
  117. Simply select  the color of your choice. In the 256 color mode you can scroll
  118. through the remaining colors by pressing on the up or down gadgets.
  119.  
  120.  
  121. Pallete editing...
  122.  
  123. Press the PAL gadget, select a color, use the RGB scrollers and gadgets to
  124. modify the color.
  125.  
  126.  
  127. Adding graphics to your programs...
  128.  
  129.   One of the great features of Raster Master is its ability create images
  130.   compatible with the standard graphic libraries included with Turbo C,
  131.   QuickC, Turbo Pascal, and QuickBASIC. Raster Master also supports additional
  132.   libraries like Fastgraph and TEGL Windows Toolkit. Source code can be
  133.   generated for images, palettes, and mouse pointers.
  134.  
  135.  
  136. 1.  RM RAW               - Raster Master's RAW format.
  137.  
  138. 2.  Palette              - Binary format containing RBG values.
  139. 3.  Palette (C)          - Source code in C for the palette.
  140. 4.  Palette (PAS)        - Source code in Pascal for the palette.
  141. 5.  Palette (BAS)        - Source code in BASIC for the palette.
  142.  
  143. 6.  TP/TC (Binary)       - Turbo C/Pascal binary image format to be displayed
  144.                            with the putimage function.
  145.                      
  146.                            see Demo1.c for Turbo C
  147.                            see Demo1.pas for Turbo Pascal
  148.                            For 256 color images you must use the supplied
  149.                            SVGA256.bgi driver.
  150.  
  151.  
  152. 7.  TP Constants         - Turbo Pascal source code for format 6
  153.                            see Demo2.pas
  154.  
  155. 8.  TC Constants         - Turbo C source code for format 6
  156.                            see Demo2.c
  157.  
  158. 9.  QC/QB (Binary)       - QuickC/BASIC binary image format to be displayed with
  159.                            _putimage (QC) or PUT (QB).
  160.                            See Demo3.c for QuickC
  161.                            See Demo1.bas for QuickBASIC
  162.  
  163. 10. QC Constants         - QuickC source code for format 9
  164.                            see Demo4.c
  165.  
  166. 11. BASIC DATA           - QuickBASIC source code for format 9
  167.                            see Demo2.bas
  168.  
  169. 12. TEGL DEF             - TEGL Windows Toolkit text based HEX format
  170.                            Refer to manual and TEGL code for DEF.
  171.  
  172. 13. PPR  Fastgraph       - Fastgraph Packed Pixel Run format. 16 colors or less.
  173.  
  174. 14. SPR  Fastgraph       - Fastgraph Single Pixel Run format. max 256 colors.
  175.  
  176. 15. FG PPR (C)           - C code for format 13
  177. 16. FG SPR (C)           - C code for format 14
  178. 17. FG PPR (PAS)         - Pascal code for format 13
  179. 18. FG SPR (PAS)         - Pascal code for format 14
  180. 19. FG PPR (BAS)         - Basic code for format 13
  181. 20. FG SPR (BAS)         - Basic code for format 14
  182.  
  183.                           Refer to the Fastgraph user and reference manuals.
  184.                           Use the included program xinfo.exe to obtain the run
  185.                           count and width from Raster Master created  SPR and
  186.                           PPR files.
  187.  
  188. 21. Mouse (C)            - C code for mouse image.
  189. 22. Mouse (PAS)          - Pascal code for mouse image.
  190. 23. Mouse (BAS)          - Basic code for mouse image
  191.  
  192.                           When saving in this format only the first 16X16 pixels
  193.                           from the left top corner will be saved. If the image
  194.                           is clipped only the first 16X16 pixels starting from
  195.                           the top left corner of the clipped image will be
  196.                           saved.
  197.  
  198.  
  199.                           The colors black, white, and dark blue are used to
  200.                           build the mouse image. Dark blue will be considered
  201.                           transparent. Any other color is used to indicate that
  202.                           the screen pixel under the mouse image will be
  203.                           inverted.
  204.  
  205.  
  206.  
  207. THE 'RAW' FORMAT
  208.  
  209.   Raster Master supports its own format for saving and retrieving files. The
  210.   format is broken up into three main parts. The header, palette, and image
  211.   portions.
  212.  
  213.                        ---  HEADER  ---
  214. Bytes
  215. -----
  216. 1 , 2 - Width of Image
  217. 3 , 4 - Height of Image
  218. 5 , 6 - Number of Colors - if 0 image does not contain a palette
  219.  
  220.                       ---  PALETTE  ---
  221.  
  222. 7 , 8 , 9  - Red, Green, Blue values of the first color. The values will range
  223.              from 0 to 63. Each additional three bytes indicate the values of
  224.              the next color. For an image that contains 16 colors the PALETTE
  225.              size will be 48 bytes (3*16).  
  226.  
  227.                         ---  IMAGE ---
  228.  
  229. What ever follows after the palette is the actual image. The first byte
  230. following the palette will be the first pixel starting from the left top corner.
  231. The remaining pixels follow row by row. Each pixel takes exactly one byte no
  232. matter how many colors there are in the image.
  233.  
  234.  
  235. The api...
  236.  
  237.   Raster Master also supports additional formats with its tiny API system.
  238. Raster Master does this by allowing the programmer to write a conversion program
  239. that will be executed automatically when the format is selected. When selecting
  240. the change format option (RIGHT mouse over OPEN or SAVE) Raster Master will look
  241. for a file called RM.FIL. This is a standard TEXT file that will contain the
  242. parameters of your conversion program. Lets say you want to write a conversion
  243. program that will save your image as a GIF file. The first line of RM.FIL should
  244. be:
  245.  
  246. RAW2GIF.EXE GIF 1 W CIS_GIF_FORMAT
  247.    |         |  | | |_________________  Format Description 
  248.    |         |  | |
  249.    |         |  | |___________________  Read/Write
  250.    |         |  |  
  251.    |         |  |_____________________  Format Number            
  252.    |         |
  253.    |         |________________________  Format Extension
  254.    |
  255.    |__________________________________  Filename                 
  256.                           
  257.                                        
  258. FILENAME of conversion program must 12 characters or less.
  259.  
  260. FORMAT EXTENSION must be 3 characters or less
  261.  
  262. FORMAT NUMBER must be 3 character or less
  263.  
  264. FORMAT TYPE must 1 character. Either 'W' OR 'R'. The W indicates that the listed
  265. format will only appear in the 'Save format menu.'  The R indicates that it will
  266. appear in the 'open format menu.'
  267.  
  268. FORMAT DESCRIPTION must be 20 characters or less
  269.  
  270. The FORMAT EXTENSION is required by the file requester to list the appropriate
  271. files.
  272.  
  273. The FORMAT number is what will be passed to your conversion program in the
  274. command line parameters.  One conversion program can have more than one input
  275. and/or output format(s).
  276.  
  277. The conversion program will be executed by Raster Master in the following manner
  278. when a file is being saved:
  279.  
  280. RAW2GIF.EXE <FILENAME> <FORMAT NUMBER>
  281.  
  282. Once your conversion takes over there will be a file called RM$$.RAW in the
  283. current directory that it must convert to the specified format and name.
  284. The RM$$.RAW file is saved just like the previously described RAW format. The
  285. RM$$.RAW file will be deleted by Raster Master automatically after your
  286. conversion program is through with it.
  287.  
  288. If your going to write a conversion program that reads an image into Raster
  289. Master you must create the RM$$.RAW file from your original format. Raster
  290. Master passes the following parameters when executing a conversion program for
  291. reading an image.
  292.  
  293. GIF2RAW <FILENAME> <FORMAT NUMBER> <X> <Y> <X2> <Y2> <PAL>
  294.  
  295. The additional information indicates the co-ordinates that the image will be
  296. displayed in. If the <PAL> value is 1 it means that you may include a palette in
  297. the RM$$.RAW file. If 0 it means that a palette is not required and will not be
  298. used.
  299.  
  300. Your conversion program should not display any kind of messages.
  301.  
  302.  
  303. Registeres users...
  304.  
  305.  The format of the key file has been changed from versions prior to 3.0. You
  306. can upgrade your key by sending a filled registration form along with $8.
  307. Include the word upgrade in the comments/suggestion area. This was a necessary
  308. change in order to accommodate the new format Raster Master is released under.
  309.  
  310. BBS users may call Baudeville BBS and leave a private message to
  311. 'NICK ONOUFRIOU' with your name/address and invoice number. When you call back
  312. 24 hours later there will be a new key file waiting for you, no other calls will
  313. be necessary.
  314.  
  315. The key file should be placed in the same directory as your RM.EXE file.
  316.  
  317.  
  318. Registering...
  319.  
  320.  Raster Master is NOT free software. If you use this program you must pay for
  321. it. Registration entitles you to a key file that removes the nag screens and
  322. enables the 256 color "save option." For a limited time you will also
  323. receive BONUS programs when you register! See BONUS.TXT for more information.
  324.  
  325.  Raster Master is updated constantly with new features being added all the time.
  326. Fill out ORDER.TXT or VISAORDR.TXT to register.
  327.  
  328.